<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 25.0px Helvetica}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
    p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
    p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 18.0px Helvetica}
    p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
    span.s1 {text-decoration: underline}
  </style>
</head>
<body>
<p class="p1">Output</p>
<p class="p2"><br></p>
<p class="p3">With the <b>Output</b><i> </i>panel, the user can control the attributes of the sound outputted by Cecilia.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<center><img src="./images/output.png" alt="Cecilia's Output panel"></center>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>Output file</b></span></p>
<p class="p2"><br></p>
<p class="p3">When pushing the <i>Rec </i>button in the <b>Main Control</b> panel, the output sound is written into a soundfile. This soundfile must be defined in the <i>Filename</i> field of the <b>Output</b> panel:</p>
<p class="p2"><br></p>
<center><img src="./images/outputFilenameEmpty.png" alt="Cecilia's Output File name"></center>
<p class="p2"><br></p>
<p class="p3">To do so, click on the <i>folder</i> icon of the Output Tools:</p>
<p class="p2"><br></p>
<center><img src="./images/outputTools.png" alt="Cecilia's Output File Tools"></center>
<p class="p2"><br></p>
<p class="p3">This action will open a <i>Save as...</i> dialog. Using that dialog, the user can define the path and filename of the soundfile that will be created on a rendering performance.</p>
<p class="p2"><br></p>
<p class="p3"><span class="s1">Note</span> If more that one rendering performance is made using the same output filename, Cecilia will not overwrite the previous soundfile created. It will automatically create soundfiles with the same filename followed by the extension _00x, incrementing everytime a sound is created.</p>
<p class="p2"><br></p>
<p class="p5"><b>Output File Tools:</b></p>
<p class="p3">The <b>Output</b> panel includes a series of four tools:</p>
<p class="p2"><br></p>
<center><img src="./images/outputTools.png" alt="Cecilia's Output File Tools"></center>
<p class="p2"><br></p>
<p class="p3">With those tools the user can listen, edit, modify or reuse the output soundfile.</p>
<p class="p2"><br></p>
<p class="p3">Clicking on the <i>speaker</i> icon will open the soundfile in the player application. It allows the user to hear the soundfile without any processing. The player application must be set in the <i>Preference Panel</i>.</p>
<p class="p2"><br></p>
<p class="p3">The <i>scissors</i> icon opens the soundfile in an edition application. The soundfile can then be edited after being created in Cecilia. The edition application must be set in the <i>Preference Panel</i>.</p>
<p class="p2"><br></p>
<p class="p3">The <i>folder</i> icon helps the user define the soundfile name and path that will be created by Cecilia. It opens<span class="Apple-converted-space">  </span>a save file dialog.</p>
<p class="p2"><br></p>
<p class="p3">The <i>recycle</i> icon is a shortcut for the user to rapidly use the output soundfile as an input soundfile. Clicking on it will automatically replace the soundfile in the input panel by the one defined in the <i>Output filename</i> field.</p>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>Performance duration</b></span></p>
<p class="p2"><span class="Apple-converted-space"> </span></p>
<p class="p3">The Cecilia performance is a timed process. Which basically means that the input sound will be processed for a fixed amount of time. This performance time can be set using the <i>Duration</i> slider in the <b>Output</b> panel:</p>
<p class="p2"><br></p>
<center><img src="./images/outputDuration.png" alt="Cecilia's Performance Duration slider"></center>
<p class="p2"><br></p>
<p class="p3">As the user moves the <i>Duration</i> slider, the X-axis of the graph reajusts to the new performance duration. Shift-clicking on the knob of the slider lets the user type in a specific duration. The slider value can also reajust to the input sound duration when the hitting the <i>clock</i> icon (in the sampler window).</p>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>Output Gain</b></span></p>
<p class="p2"><br></p>
<p class="p3">A final gain control is available to the user in the <b>Output</b> panel. The sound produced by Cecilia can sometimes be a too loud or not loud enough. The <i>Gain</i> slider gives the user the possibility to adjust the level of the signal right before it is sent to the <i>DAC</i> or the soundfile.</p>
<p class="p2"><br></p>
<center><img src="./images/outputGain.png" alt="Cecilia's Output Gain slider"></center>
<p class="p2"><br></p>
<p class="p3">It has a range of 66dB, going from -48dB to +18dB. Shift-clicking on the knob of the slider lets the user type in a specific gain value. The slider value can also reajust to the peak value (refers to the Peak Value section)</p>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>VU Meter</b></span></p>
<p class="p2"><br></p>
<p class="p3">A continuous VU Meter lets the user see the current level of the outcoming signal:</p>
<p class="p2"><br></p>
<center><img src="./images/outputMeter.png" alt="Cecilia's Output VU Meter"></center>
<p class="p2"><br></p>
<p class="p3">The VU Meter is a graphical interface presenting the level of a signal. Every horizontal bar in the VU Meter represents the signal level of one channel. From Cecilia's VU Meter, the user can read the value of a signal from the transition between the lighter and darker tone in an horizontal bar. Every division in that horizontal bar represents a 3dB step.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p3">The VU Meter automatically reajusts in size to the Output format.</p>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>Output Format</b></span></p>
<p class="p2"><br></p>
<p class="p3">Cecilia can output sound in various formats. The <i>Output Format </i>can be chosen using the context menu in the <b>Output</b> panel:</p>
<p class="p2"><br></p>
<center><img src="./images/outputFormat.png" alt="Cecilia's Output Format"></center>
<p class="p2"><br></p>
<p class="p3">Available standard formats are Mono, Stereo, Quad, 5.1 and Octo. The user can also customize the <i>Output Format</i> by clicking <i>Custom...</i> :</p>
<p class="p2"><br></p>
<center><img src="./images/outputFormatChoice.png" alt="Cecilia's Output Format Choices"></center>
<p class="p2"><br></p>
<p class="p3">This output process is independant to the format of the input sound (thanks to Cecilia's sampler).</p>
<p class="p2"><br></p>
<p class="p3">In the present version of Cecilia, the only two available formats are Mono and Stereo. Multichannel formats will soon be available. In the meantime, choosing a custom format, the user will have to build his own<span class="Apple-converted-space">  </span>Cecilia module that supports the specific number of channels.</p>
<p class="p2"><i></i><br></p>
<p class="p4"><span class="s1"><b>Peak Value</b></span></p>
<p class="p2"><br></p>
<p class="p3">The maximum value of the VU Meter is stored in a display called <i>Peak</i>:</p>
<p class="p2"><br></p>
<center><img src="./images/outputPeak.png" alt="Cecilia's Output Peak Value"></center>
<p class="p2"><br></p>
<p class="p3">That value is updated everytime the level of a outcoming signal go higher to the current <i>Peak Value</i>:</p>
<p class="p2"><br></p>
<center><img src="./images/outputVUMeterPeak.png" alt="Cecilia's Output Peak Value in action!"></center>
<p class="p2"><br></p>
<p class="p3">Optimal value is 0dB. The gain ajustment based on the Peak value can be automatically done by Cmd+click on the <i>Peak Value</i>. Double-clicking on the <i>Peak Value</i> will reset it to it's minimum value (-90dB).</p>
<p class="p3"><br></p>
<p class="p3"><br></p>
<center><p class="p3">Return to <a href="./usingCecilia.html">Using Cecilia</a> section</p></center>
</body>
</html>
